package com.gobang.domain.dto;

import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Positive;
import lombok.Data;
import lombok.Builder;
import lombok.NoArgsConstructor;
import lombok.AllArgsConstructor;
import com.fasterxml.jackson.annotation.JsonProperty;


/**
 * 匹配请求数据传输对象
 * 用于用户请求加入匹配队列时的参数传递
 *
 * @author gobang-team
 * @since 1.0.0
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class MatchRequestDTO {

    /**
     * 用户ID
     * 必须为正数，用于标识请求加入匹配队列的用户
     */
    @NotNull(message = "用户ID不能为空")
    @Positive(message = "用户ID必须为正数")
    @JsonProperty("userId")
    private Long userId;
} 